Getting startet:
----------------

Put some music on your sd card. Calaym for Android currently expects your music to be located in
<DirRootExternal>/Music
which is most likely (?)
/mnt/sdcard/Music
Note the capital M (might matter, as android is linux based)

Layout:
The layout changes as you interact.
However, at the bottom are some buttons that are always available, which currently are:
 - Play/Pause
 - Repeat mode
 - Quit

You may switch layouts by slinding the display left or right (not working at the bottom area)

  Folders <-> Current folder <-> player <-> search

Install on sd-card?
  Makes partly sense, as Calaym relies on the music on the sd card.
  However, if installed on phone, you can start Calaym even if android's media
  scanner hasn't scanned apps on sd card yet. Calaym does not rely on the media
  library.

Folders:
  Shows any folder containing music (music in subfolders)
  Klick to switch to current folder view

Current folder
  Shows a single folder content
  Klick on the folder item on top of the list to switch to Folder view
  Klick on any song to play item. This Will automatically switch you to player view
  Long klick on any song to invoke a popup menu, allowing to share or delete file

Player
  Currently shows mostly debug stuff
  You can click on the player debug text (P0, P1 ...) to skip song
  An position scroller is also included and may be used to seek the current song

Search
  Allowes you to search the playlist
  Klick on folders to open them in current folder view (from there, you can
    click on the folder item on the top of the list to switch to folder view)
  Klick on any song to play item. This Will automatically switch you to player view
  Long klick on any song to invoke a popup menu, allowing to share or delete file

Pending features:
last played songs maybe?
fixed? title not available sometimes on startup
shortcut to media volume, mixer, or custom popup / dialog / interface
default app (for headset button)
get rid of vertical scroll view?
add some more styles, also to make it easier to distinguish current view(s)
any some more
maybe hat higher res images for additional controls

Hidden features:
 - when connecting (wired only?) headset, Calaym will fade in volume
 - when disconnecting (wired only?) headset, Calaym will fade out and pause
 - on incoming/outgoing calls, Calaym will fade out, pause and resume afterwards
 - on headset (wired only?) button click Calaym will pause/unpause
 - on headset (wired only?) longer button press, Calaym will switch songs (fast crossfade)
 - long pressing songs in current directory will invoke a popup menu, allowing
   to share or delete file
 - long pressing songs in search will invoke a popup menu, allowing to share or
   delete file
 - Multilanguage support (english / german currently included)

Legal stuff:
------------

 - You can use this software under the terms of the User-friendly Open source
   License Version 1.00, published by Jan Vorel;
 - You can redistribute the official software packages under the terms of the
   User-friendly Distribution License Version 2.00, published by Jan Vorel.

Used libraries:
---------------

 - BroadcastReceiver - Sends and receives Broadcasts in the Android Operating
   System. (by XverhelstX - Tomas Verhelst)

 - Reflection 2.4 - Reflection library for runtime creation and manipulation of
   Java classes and object instances. (by Agraham - Andrew Graham)

 - id - inputlist without radio controls (by Maximus / thedesolatesoul ?)

Thanks:
-------
 - Marlene Vorel for letting me test on her tablet
 - Basic4Android, the community etc

Recent changes:
---------------

 1.00 beta 2:
  - Fix: SEVERAL internal and minor visual BUGS
  - Add: Dual-views in landscape mode on large displays;
         (folders+files <-> files+player <-> or player+search)
  - Add: Main 'buttons' now on panel with gray background
  - Add: Support for dual storage (sdcard/Music + sdcard/external_sd/Music)
         (As encountered on the Galaxy S Advance I9070P...)
  - Add: Search results are sorted

 1.00 beta 1:
   Almost everything I wanted the player to be, working and fully functional.
   Or so it appears. It has all features I considered essential, like fading,
   crossfading, search and some automatic playback features. Plus the mobile
   device related features.
